home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / ratio111.zip / SPRATIO.DOC < prev    next >
Text File  |  1993-01-20  |  13KB  |  243 lines

  1.  
  2.  
  3.               SPitfire RATIO checker/upgrader/degrader (SPRATIO)!
  4.  
  5.                               By John Pittman Jr.
  6.  
  7.  
  8.    First the boring stuff:
  9.        The author permits temporary rights to use  this program for a term of
  10.    no more than thirty (30) days, provided that you do not use it in a manner
  11.    that it is not intended, reverse  engineer, or otherwise alter the program
  12.    or any of it's accompanying files in any way not intended.
  13.  
  14.        The author places  no guarantee on the operation  or integrity of this
  15.    program and is and cannot  be held responsible for  damages or losses that
  16.    occur from, during use of, or otherwise  related to this program. It is in
  17.    plain sense that  this program  and it's counter-parts  are under an as is
  18.    basis and you are to use this program at your own risk!! Over & Out!
  19.  
  20.     The good stuff:
  21.        This program was  written for SPITFIRE  versions 3.x (ONLY tested with
  22.    version 3.2) to  perform a READ of  the SPITFIRE user file  and perform an
  23.    upload download ratio check on the level specified on the command line. It
  24.    will adjust the users level to the violation level specified if the user's
  25.    is in violation of the UL/DL Ratio. It will also adjust the users level to
  26.    the good standing level if he/she is not in violation of the UL/DL Ratio.
  27.  
  28.        This program  was written to  take the pain out  of HAND-EXAMINING the
  29.    users on my BBS in order  to upgrade their access if they are contributing
  30.    as well as  recieving. And to degrade those  users who are in violation of
  31.    the special ratio I have arranged.
  32.  
  33.        This program  is NOT intended to replace  the ratio checking that Mike
  34.    Woltz has already placed  in the software (as it does just  about the same
  35.    thing). This  just gives you the option  of having more  than one ratio so
  36.    that users  who contribute more  than others can  be rewarded. And it adds
  37.    A few more features described a bit more in detail below.
  38.  
  39.  
  40. --[ FILES YOU SHOULD HAVE WITH THIS VERSION ]--------------------------------
  41.  
  42.    SPRATIO.EXE  - The MAIN program itself!!
  43.    SPRATIO.DOC  - This file that you are reading right now.
  44.    SPRATIO.CFG  - A SAMPLE configuration file. SEE CONFIGURATION BELOW!!
  45.    EXEMPT.TXT   - A SAMPLE exemption file. SEE EXEMPTION OPTION BELOW!!
  46.    ORDER.FRM    - The SHAREWARE order form to REGISTER this program
  47.                   (It's cheap to register too!!!)
  48.  
  49.  
  50. --[ SETTING IT UP]-----------------------------------------------------------
  51.  
  52.     1>    Copy ALL the files into their own directory.
  53.     2>    Using an ASCII text editor, edit the path in the configuration file
  54.           to reflect the location of your SPITFIRE user file.
  55.           (Default file included is C:\SF\WORK\ )
  56.     3>    Review the command line options below and enter them.
  57.           If you'll be runing this as an EVENT then place this in your SF.BAT
  58.           batch file under the event you want. For the proceedure on EVENT
  59.           setup, see the documentation that came with your SPITFIRE BBS
  60.           Software.
  61.  
  62.    That's it to the operation! EASY isn't it! That's the idea!
  63.  
  64.  
  65. --[ COMMAND LINE ]-----------------------------------------------------------
  66.  
  67.    SPRATIO [LEVEL] [GOOD] [BAD] [UL/DL RATIO]
  68.  
  69.        LEVEL       = This is the level that you will be scaning
  70.        GOOD        = This is the level the user is set to if he/she
  71.                        IS NOT IN VIOLATION of the ratio
  72.        BAD         = This is the level the user is set to if he/she
  73.                        IS IN VIOLATION of the ratio
  74.        UL/DL RATIO = This is the WARNING RATIO of uploads to downloads
  75.                        for the level your trying to maintain!
  76.                            (IE. If your BBS requires that the users who want
  77.                            high access must strictly adhere to the 1 upload
  78.                            to 2 downloads ratio, then set this to a 2 (yes,
  79.                            the ratio is always in comparison to 1 upload!!).
  80.  
  81.  **NOTE - Your not supposed to include the brackets either, just a reminder!!
  82.  
  83.  
  84. --[ CONFIGURATION ]----------------------------------------------------------
  85.  
  86.       The configuration file allows YOU, the operator, to specify the path of
  87.    your SFUSERS.DAT file (including the final "\" backslash!). And whether or
  88.    not you will be using an EXEMPTION  OPTION list as well as an ASCII output
  89.    file that is in SPITFIRE FILE FORMAT including control characters to clear
  90.    the screen,  and include  a <MORE>  prompt. You  can also  create listings
  91.    of the users with their UPLOADS & DOWNLOADS listed or not listed. There is
  92.    also a  feature that  allows you  to select  whether you  want to upgrade,
  93.    degrade, or no adjust your users who have a ratio of zero uploads and zero
  94.    downloads.
  95.  
  96.  
  97. SAMPLE FILE:
  98.  
  99. C:\SF\WORK\     - Path to your SFUSERS.DAT file (INCLUDE THE LAST BACKSLASH!)
  100. NO            * - YES/NO - Exemption Option List Toggle
  101. YES           * - YES/NO - Write ASCII Output File Toggle
  102. NO            * - YES/NO - DISPLAY ULDS & DLDS in ULCLL OPTION
  103. NONE          * - DEGRADE/UPGRADE/NONE - 3-Way Toggle setting for 0:0 Ratios
  104. 3             * - Number of lines you will have in your OPTIONAL ENDER(3 Max)
  105. ....          * - Line 1 of ASCII text that will show up in OPTIONAL ENDER
  106. ....          * - Line 2 "    "    "    "    "    "   "  "     "       "
  107. ....          * - Line 3 "    "    "    "    "    "   "  "     "       "
  108.  
  109.  * - These options are ONLY AVAILABLE IN THE REGISTERED VERSION. You may omit
  110.      these lines in the  SHAREWARE version if you  like. I recommend that you
  111.      leave them there though.
  112.  
  113.  
  114. --[ EXEMPTION OPTION ]-------------------------------------------------------
  115.  
  116.        The exemption  option file allows  YOU, the operator, to  omit certain
  117.    users from being  examined if the  level you are checking  is the level of
  118.    that user and you don't want that user's  level changed or altered at all.
  119.    Names are entered ONE  per line followed by pressing  the ENTER key. Names
  120.    format is that of SPITFIRE, the first letter of each word in the name must
  121.    be a capital letter. For example,  Jerome Fletchbetter (Not an actual name
  122.    I know of, but serves it's  purpose) would be entered just as it says. See
  123.    the sample file I have included for a few more examples.
  124.  
  125.  
  126. --[ ASCII OUTPUT DISPLAY FILE ]----------------------------------------------
  127.  
  128.        The ASCII  output file is  made from a  header, ALL  the modifications
  129.    that are made to the  SPITFIRE users file, followed by a SHAREWARE ending.
  130.    The file  that is  created  is straight  ASCII form  that is  used for ALL
  131.    *.BBS screens  used in SPITFIRE . The filename is  ' SPRATIO.BBS '. If the
  132.    file is already existant in the current  directory, it will be overwritten
  133.    by the new one. In  order to use this file as  a display file on your BBS,
  134.    you  will have  to follow  the command  line with  a copy to  the path and
  135.    filename that you want the file to be named. An Example is below:
  136.  
  137. @ECHO OFF
  138. CD\SPRATIO
  139. SPRATIO 20 15 25 5
  140. COPY SPRATIO.BBS C:\SF\DISPLAY\BULLET1.BBS
  141. CD\SF
  142.  
  143.        The output  file also  has a  clear  screen control  character  in the
  144.    begining and at  the end it  has the <MORE>  prompt control  characters to
  145.    enable the prompt  and place the prompt on the  screen. That's it! You now
  146.    have a bulletin for use on your bbs.
  147.  
  148. --[ 3-WAY 0:0 RATIO TOGGLE ]-------------------------------------------------
  149.  
  150.        The three-way  toggle  option  gives  you, the  sysop, the  ability to
  151.    decide  how  you  want to  handle  your users  who  have  a  ratio  of 0:0
  152.    ( 0 Uploads and 0 Downloads ). Upon locating a user whose ratio reflects a
  153.    ratio of 0:0, it will either NOT ADJUST the users level, DEGRADE the users
  154.    level ( To what was  specified on the command  line ),or UPGRADE the users
  155.    level ( To what was specified on the command line ). See the Configuration
  156.    information for how to set this option and where.
  157.  
  158.  
  159. --[ OPTIONAL ENDER ]---------------------------------------------------------
  160.  
  161.        The OPTIONAL ENDER  gives you the ability  to follow your scanning and
  162.    adjustments with  the BOX that follows  the SHAREWARE version,  but with a
  163.    bit of a twist. You can have UP  TO 3 LINES ONLY, but you may use 2, or 1.
  164.    The choice is  yours. Each line of text can be  up to but not exceeding 69
  165.    letters.  Any letters  after  the  69th  character  will  be cut  off  and
  166.    discarded.  The  text is  printed to the  screen and  to the ASCII  OUTPUT
  167.    DISPLAY FILE as well. To disable  this feature, set the number of lines to
  168.    the number 0  and it will eliminate the  ENDER completely  from the screen
  169.    and the FILE. You MUST have  enough lines of text for the number you enter
  170.    at NUMBER OF LINES  position. See CONFIGURATION  for the format and layout
  171.    of this option.
  172.  
  173.  **NOTE - This OPTION IS NOT AVAILABLE in the SHAREWARE version. You will
  174.           always get the SHAREWARE ENDER in an UNREGISTERED COPY!!
  175.  
  176.  
  177. --[ USER LEVEL COMMAND LINE LISTING & THE ULCLL OPTION TOGGLE ]--------------
  178.  
  179.        I created this  option because  I thought that  maybe some of you were
  180.    thinking, "Hmm..... It  displays the CHANGES  but why not make it have the
  181.    ability to list ALL the users who have a certain level and show the number
  182.    of uploads and downloads that person has made?". Well, I've done it and it
  183.    too is very  easy to impliment.  Simply when you enter  the command on the
  184.    command  line, enter  the level  you want to  list for ALL  three of these
  185.    positions. For example, to list ALL the users of level 40 you'd type this,
  186.  
  187.     SPRATIO 40 40 40 1
  188.  
  189.        The last number is  for display purposes only. It  gets printed at the
  190.    top in the  scaning message  stating what  the download  ratio is for that
  191.    level! Don't forget that!! It's for display purposes and MUST be there for
  192.    the message to make any sense  at all. This option does not write any data
  193.    TO the SFUSERS.DAT  file at all. All  it will  do is read  the information
  194.    from  the  file  and  display it  to the  screen  and  it  writes  to  the
  195.    SPRATIO.BBS  file as  well. This makes  it convienient  for you  to create
  196.    complete level listings of  your users and their upload & download counts.
  197.    This option  is FREE to  ALL! But  the file  option is  still a REGISTERED
  198.    OPTION You will be able to see on the screen who's at the level but not in
  199.    any file. To use this option  multiple times and create many display files
  200.    of your levels, you  will have to copy  the SPRATIO.BBS  file over to your
  201.    display file, naming it something  different during the copy. Then you can
  202.    execute the program again and follow the same proceedures.
  203.  
  204.       The listing  of the  upload and  download counts  for each  user can be
  205.    disabled by setting the ULCLL OPTION TOGGLE (in the configuration file) to
  206.    'NO'! If you  would like to have  them listed along  with the persons name
  207.    and level then you will have to set the toggle to 'YES'!
  208.  
  209.  
  210. --[ REGISTERED FEATURES ]----------------------------------------------------
  211.  
  212.        Features that you get when you register your version of SPRATIO are
  213.    as follows:
  214.  
  215.  
  216.     SPRATIO EXEMPTION LIST OPTION
  217.     ASCII OUTPUT DISPLAY FILE
  218.     3-WAY 0:0 RATIO TOGGLE
  219.     OPTIONAL ENDER
  220.     ULCLL OPTION TOGGLE
  221.  
  222.  
  223.        These options are not available in the SHARWARE VERSION!!  If you like
  224.    the speed  and accuracy  of SPRATIO, you  can register  the software and I
  225.    will send to  you the current  REGISTERED  version tagged with  your name.
  226.    Your name will appear  on the display screen during  execution and it will
  227.    also appear in the ASCII output display file. See the file 'ORDER.FRM' for
  228.    details and  more information  on what you  get and how  to order YOUR OWN
  229.    version of SPRATIO (SPitfire RATIO!).
  230.  
  231.  
  232. --[ PROBLEMS & OTHERS ]------------------------------------------------------
  233.  
  234.        For a  more current  version  or if  your  having  problems with  this
  235.    program you can contact my BBS! The ABACUS BBS (717)633-7232 . And leave a
  236.    comment to the SysOp!
  237.  
  238.                                                   Thanks & Enjoy!
  239.                                                      - John Pittman
  240.  
  241. @January 8th, 1992 ----------------------------------------------------------
  242.  
  243.